{{tag>Focal scrcpy Application Tutoriel Android Partage Ecran}}

{{ :scrcpy.png?100|Logo Scrcpy}}

====== Scrcpy ======
**Scrcpy** est un logiciel open source permettant d'utiliser ou de cloner l'affichage de son smartphone Android sur son ordinateur.

===== Pré-requis =====

  * Disposer des [[sudo|Droits de super utilisateur]].
  * Disposer d'une connexion internet.
  * Un smartphone sous Android 5.0 ou plus.
  * Un câble permettant de relier votre smartphone a votre ordinateur.

===== Installation =====
[[:tutoriel:comment_installer_un_paquet|Installez les paquets]]**[[apt>adb|adb]]**, **[[apt>scrcpy|scrcpy]]**

===== Utilisation =====

<note important>Pensez à activer le **débogage USB** (mode développeur / ADB) sinon **Scrcpy** ne fonctionnera pas :\\
- Sur votre téléphone : Paramètres > Système > "À propos du téléphone" > Tapoter **7 fois** sur le « numéro de build » => Le menu « options pour développeurs » apparaît dans les paramètres système.\\
- Aller dans Paramètres > Système > « options pour développeurs » > activer "**débogage USB**"
</note>

Pour que **scrcpy** fonctionne, le téléphone doit être actif, comme pour une utilisation normale. L'écran doit donc être déverrouillé de la façon habituelle (code PIN, empreinte digitale)... Vous pouvez ensuite lancer le logiciel (en tapant **scrcpy** au terminal, ou en cliquant sur un [[raccourci-lanceur|lanceur]] que vous aurez créé).

Pour lancer une application : cliquez dessus à la souris.

Pour passer d'un écran virtuel du téléphone à un autre : faire tourner la molette de la souris.

Pour fermer **scrcpy** : clic sur le bouton de fermeture de sa fenêtre.

{{:scrcpy.jpg?400|}}

==== Avec câble ====

Pour utiliser **Scrcpy** il vous faudra brancher votre smartphone a votre pc **ouvrir** un **terminal** et exécuter la commande  
  scrcpy
ou mieux :
  scrcpy -S
Cette option (-S) éteint l'écran du téléphone sans éteindre sa réplication sur votre écran de PC.

Cette application a plein de fonctionnalités que nous pouvons afficher en exécutant 
  scrcpy --help
  
Si lors d'un lancement du logiciel vous avez un message d'erreur au terminal du genre 
  adb: error: failed to get feature set: no devices/emulators found
l'autorisation ADB ("débogage USB") est sans doute à réactiver (l'option peut se désactiver lors de certaines manipulations, ou lors de l'extinction complète du téléphone).

__Attention__, si votre téléphone est prévu pour se mettre en veille au bout d'un délai (disons 1Mn), **scrcpy** ne l'empêchera pas : la réplication d'écran s'éteindra aussi sur votre PC. Un clic **droit** réactive l'écran, mais s'il faut un déblocage (type empreinte digitale, code, etc ...) il faudra le saisir pour que la réplication remontre le téléphone.
  
==== Sans Cable ====

<note important>Avant de l'utiliser **SANS CÂBLE** essayez avec un câble pour voir si tout fonctionne correctement</note>

Pour utiliser **Scrcpy** sans câble c'est déjà plus complexe 

Brancher votre smartphone a votre pc et ouvre un terminal

Dans un terminal exécutez :
   adb tcpip 5555
cela donnera le port de connexion au smartphone.

Bien sûr 5555 est le port de connexion mais vous pouvez bien évidement le changer.

Vous pouvez maintenant débrancher votre câble reliant votre smartphone à votre pc. 

Maintenant il faut récupérer l'ip de votre smartphone pour cela il faut aller dans Paramètre > À propos (tout en bas) > État > Adresse IP

Connectez le smartphone avec:
   adb connect address_ip_smartphone

Vérifions si il est bien connecté:
   adb devices

Le retour devrait être :
   List of devices attached
   device_ip_address:5555 device

C'est bon on peut utiliser scrcpy comme si on avait un câble
<note>Si vous avez des ralentissements, lag  cela peut venir de la distance avec votre point d’accès WIFI</note>   

Pour fermer la connexion entre votre smartphone et votre pc il faut juste faire :
   adb kill-server

==== Commandes ====
Voici une rapide présentation :

La commande
   scrcpy --always-on-top
permet de mettre au premier plan la fenêtre. 

La commande
  scrcpy -n
permet de faire un clonage de l’écran sans pouvoir contrôler le smartphone depuis l'ordinateur. 

La commande
  scrcpy -K
permet d'utiliser un clavier USB (version de scrcpy  >= 1.20)

La commande
  scrcpy --record file.mp4
permet d'enregistrer l’écran de votre smartphone en l’affichant sur l’écran de l'ordinateur.

La commande ''scrcpy -N'' s'utilise avec la commande ''scrcpy --record file.mp4'' donc la commande est :
  scrcpy --record file.mp4 -N
Elle enregistre l’écran de votre téléphone sans afficher l’écran du smartphone sur l'ordinateur.

La commande 
  scrcpy -S
permet d’éteindre l’écran du smartphone mais continuer la diffusion sur l'ordinateur.

La commande 
  scrcpy -t
affiche un point là où le doigt est posé sur l’écran du smartphone.

La commande 
  scrcpy --window-title Nom_De_L_a_Fenetre
permet de renommer la fenêtre.

<note>Personnellement j'utilise la commande 
  scrcpy --window-title Honor8 -S
</note>

==== Raccourcis ====

Des raccourcis sont disponibles pour utiliser son smartphone 

''Ctrl+H'' Il fait un retour menu.

''Ctrl+B'' Il fait un retour en arrière. 

''Ctrl+S'' Il va dans le multi-tache.

''Click droit'' Allume le smartphone.

''Ctrl+P'' Allume/Éteint le smartphone.

''Ctrl+O'' Éteint l’écran du smartphone.

''Ctrl+R'' Tourne l’écran si possible.

''Ctrl+N'' Ouvre le panel de notification. 

''Ctrl+Shift+N'' Ferme le panel de notification.

===== Voir Aussi =====
  * **(en)** [[https://github.com/Genymobile/scrcpy|Le github de l'application]]
  * **(fr)** [[https://korben.info/scrcpy-un-outil-en-ligne-de-commande-pour-afficher-et-controler-un-appareil-android-depuis-son-ordinateur-linux-macos-windows.html|Article sur le site de Korben]]
  * **(fr)** [[https://linuxfr.org/users/rom1v/journaux/scrcpy-une-appli-pour-afficher-et-controler-des-devices-android|Article sur Linux.fr]]


----

Contributeur: [[utilisateurs:zaienj|Zaienj]]